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ABSTRACT 


The Purdue/LARS Computer User's Guide is designed to docu- 
ment and incorporate all the basic information one needs in 
order to gain access to the machine and to use the equipment. 
Topics covered include a description of the LARS computer faci- 
lities (both hardware and software), administrative procedures, 
documentation available, procedures for operating terminals 


and/or submitting jobs, and notes for programmers. 


The facility described in this document was initially established 
and supported by NASA Grant NGL15-005-112. The author is with 
the Laboratory for Applications of Remote Sensing and the En- 


gineering Experiment Station, Purdue University, West Lafayette, 
Indiana 47906. 
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1.0 INTRODUCTION 


2.1 PURPOSE AND USE PHILOSOPHY OF THE PURDUE/LARS COMPUTER 
INSTALLATION 


The PURDUE/LARS computer exists to supply the 
computation resources required for Remote SensIng research 
at the Purdue University Laboratory for Applications of 
Remote Sensing and at associated Remote Terminal Sites. To 
this end, facilities are avallable with as few restrictions 
as possible consistent with matntalning efficient 
utilization of resources and fairness to all users. The few 
regulations necessary for users are detalled in this gulde. 


1.2 WHAT FACILITIES ARE AVAILABLE 


The PURDUE/LARS Computer Installation provides several 
types of services: 


e The Technical Support Group provides and maintains 
the software components utilized by users of an Earth 
Resources Data Processing system. Providing software 
components is defined as analysis, design, codtng, 
and checkout of new software applications, or 
modification of existing applications for enhanced 
function. Maintaining software components Is defined 
as diagnosIng problems In existing software = and 
flxing or recommending circumventions for them, 
performing routine updates, and maintalning system 
documentation. Among these software components are; 


1. LARSYS Multispectral Image Processing System 
2. CMS Programming system 
a Fortran language compilation and 
execution 
Db. Assembler language assembly and 
execution 
c. Program and data management facilities 
(including edItor) 
3. Other LARS "Supported" Programs 
4h, LARS "Unsupported" Programs 


e The Technical Support Group’ provides a human 
Interface to the computer system. Included are the 
following areas: 


1. Control access to computer and allocation of 
resources 
a. Assign ID's and Computer Accounts 
b. Provide accounting Information 
c. Assign and manage disk storage space 
d. Assign and manage magnetic tapes 

re Present Courses and matntain Educatlonal 
Materfal related to the use of the system 
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or, Provide consultatlton on Questions and 
Problems related to the use of the system 


°* The Data Base Administration Group provides’ and 
malntains Remote Sensing Data In the form of a 
library of Multispectral Image Storage Runs. This 
includes routine reformatting of data, geometric 
correction and similar pre-processing. 


* The Operations Group is responsible for operation of 
the computer hardware. 


1.3 COMPUTER STAFF (WHO'S WH), AND WHO TO TALK TO) 


1,3,) REMOTE--TERMINAL SITE SPECIALISTS ~— In “ondemee 


expedite communtcattons, each remote terminal site 
designates three contacts whose areas of responsibility are: 


a) Steering Committee Member - This person serves 
on the Remote Terminal Steerfnz Committee and 
Is charged with administrative responsIbI lity 
and authority for the establishment and 


continuance of the remote terminal 
Installation. 
b) Hardware-Software Specialist. This person 


should be available to all users at the 
terminal sIite to sort out user problems with 
the system, hardware malfunctions, and 
software bugs. 

c) Techniques Specialflst. This person should he 
available to all users at the terminal site to 
perform educational functions and be a 
consultant on the use of LARSYS analysIs 
techniques. 


Users at remote terminal sites should contact thelr 
site specialists with all questions and problems, Instead of 
contacting PURDUE/ LARS personnel directly. The site 
specialists are then responsible for tnterfacing with thelr 
PURDUE/LARS counterparts [ff necessary. 


The current remote site speciallsts are llsted below: 


PURDUE/LARS - Committee Member - Terry Phillips 
HW/SW Speclalist - Howard Grams 
Techniques Speciallst - Barbara Davis 

NASA/JSC - Committee Member - John Sargent 
HW/SW Specialist - John Cornwell 
Techniques Specialist - 

NASA/GSFC - Committee Member 2° Willtam Alford 
HW/SW Specialist - Lottte Brown 


Techniques Speclalltst - 
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NASA/Wallops - Committee Member - Harold Maurer 
HW/SW Specialist - Tom Savage 
Techniques Specialist - David Hancock 
ODU/Langley - Committee Member Soe Tet hs te and i.) ay 
- Ruth Whitman 
HW/SW Specialist - Mary Alice Eastwood 


Techniques Speclalist - Philip Renfroe 


1.3.2 PURDUE/LARS PERSONNEL. The primary contact for 
computer-related matters for PURDUE/LARS personnel should be 


the member of the Data ProcessIng Technical Support Group 
whose job ft is to primarily provide the human Interface to 
the computer mentioned In section 1.2 above. This contact 
Is presently Jeanne Etheridge (extension 228). It Is her 
responsibility to efther take care of computer-related 
problems, LARSYS problems, programming questions or 
problems, etc. or administrative tasks (ID assignment, 
accounting reports, tape assignments, etc.), or to. refer 
them to other members of the staff when necessary. If she 
is unavailable, the secondary contact should be Howard Grams 
(extension 225). 


1,4 OPERATIONAL PROCEDURES AND GOALS 


The PURDUE/LARS computer is [n operation 24 hours a day 
except between 5PM Saturdays and 3PM Sundays. In additton, 
scheduled preventive maintenance (currently between 8am and 
10am Tuesday mornings) precludes avaflability to users at 


certain other times. Bulletin boards and the news service 
of the LARSYS system (see Sectfton 3.2) will announce 
permanent and temporary changes In the avallabIlity 
schedule. 


General policy fs to have two computer operators 9 on 
duty at all times (three during the prime shift). This will 
ensure adequate response to user requests as well as 
frequently enable operating users to obtain help In 
resolving any operational problems they may encounter. 


Expected typtcal levels of system avallabllity and 
rellabfilfty are described below: 


1. There should not be more than an average of 
two unscheduled shutdowns (system crashes) 
experfenced by any user In a week. Any such 
system fallure should be repafred within one 
hour. 


2. LARS terminals should be operational the same 
hours as the system, with less than an average 
of one fallure per week per terminal of not 
more than one working day. 


a User requests (such as tape mounting = and 
device attachment) should be honored withIn 
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two minutes. Card or printer output at the 
central computer site should be availahle 
within five minutes of production. 


AS There should be sufficient tape units 
available so that LARSYS users can obtain one 
tape unit within 10 minutes of a request or 
two tape units within 30 minutes of a request 
or more than two units within 10 hours. 


5. oThe \ adlettal display --at..the ..central,computer 
site should be operational the same hours the 
system,..is Un«..operatton,: wihithi.?l ess.<tnanoeeem 
average of one hardware fallure per week. 
Maximum recovery period from hardware fallures 
should be less than flve working days. 


1.5 ADMINISTRATIVE PROCEDURES 


Before a user can have access to the PURDUE/LARS 
computer, he must have an 1D assigned to him. This ap 
assignment defines the resources available In a user's 
virtual machine when he logs in at a terminal. Access Its 
controlled., by. predef.itned user. ID's .estabLished nn See 
computer's operating system CP-67. System accounting 
informatton Is produced for each user ID. 


Associated with Gachi cal metus a "user-td" and a 
“bassword", To use the computer a user-must ‘give the Vouh 
command with the “user-id'". The machine will ask for his 
password, and the user must type the correct "password" to 
gain access to the machine. An account number [s_ also 
assigned to each 'user-fd". The accounting procedures keep 
track of the number of times each user-id has’ obtalned 
access to the computer, how much CPU time Is used, what 
dedicated devices are used, and other accounting Information 
useful to determine resource needs and usave. 


All usage of the computer {fs charged for according to 
the number of total CPU hours used. No other parameters 
currently affect the charges. 


Vie val HOW TO ESTABLISH A _PURDU RS COM 
Users at remote terminal sIltes must establish ID's through 
his site's Hardware/Software spectallist. 


Users at PURDUE/LARS should fill out In duplicate the 
form “REQUEST FOR PURDUE/LARS COMPUTER LDS. (One copy will 
be returned to the person whose name is on Ilfne (1) and ts 


the person responsible for the account. The second copy 
willl be retained by the Technical Support Group.) A sample 
eopy {ts shown on the next page. The request should be 


signed on lItne (2) by the supervisor for the project to be 
charged (i.e., the Project Leader or PrinctIpal Investtpator) 


and then sent to Jeanne Etherldgre for processing, 
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LARS FORM 115 This Box for 
System Programmer Use Only! 
REQUEST FOR LARS COMPUTER ID 


(1) Requested by_Swatngartner pate 1-7- Account No. 
(Person responsible for account) 
USERID 
(2) Approved by Date 
(Supervisor for Project checked below) Password 
(3) Source of funding (check one): 
; Approved Init 
SRET 
(1 comp rac [J socro Eco Installed Init 
[1] DATA HDL C3 ERTS-wWv | 
{J DATA ANAL CJ erts-cou Deleted Init 
(1) MEASMETH (C1 erts-cs 
[J sorL VEG C—] SKYLABHV 7 Modifications: Date Init 
(_) crp PROD C] sxy-coLo : 
[1 sor, stub CJ REMOTE T 
(X] ERTS Phantastic Experiment 
Other SA Se 
- py [Jxes69 
C7) por Cr1rac 


pe! 
(4) Hours allowed @ $250/hr 50 


(5) GeNew Account 
C—jSame Account as ID 


(6) Expiration Date for Accomt Dec 1975 


(7) ID Requested .PHANTAS1 & PHANTASPassword Requested (Used at login time).IWCRED 
(8 Char. or less) ) (8 Char. or less) 


(8) Capability Requested: fare Special Facilities: (e.g., special disks, disk-link, 
[CILARSYS Ver 2 passwords, core size, etc.) 


CXAILARSYS Ver 3 and Ver 2 
C44 Ps 
(“cms 


(9) Person(s) who will be using this ID 


(10) Description of work to be done Detectin r 48 “: 


(11) Tapes allowed to be written on using this ID: 
Tape No. Ownen's Name Tape No. Owner's Name Tape No. Owner's Name 
543 SWAINGARTNER 
544 SWAINGARTNER 
781 SWAINGARTNER 
967 SWAINGARTNER 


ESE SOE SE RAE TON 
—— a ee Eeeieeeeeese RE 
{PRES PETES TS 
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The source of funding entered on line (3) will be used 
to determine the account catezory into which this IP will be 
Placed and tn which category of the monthly accounting 
reports it will appear. The project supervisor will recelve 
monthly accounting reports. 7 


The ID will be removed on the date specifled on line 
(5), or whenever the number of hours of CPU time on line (4) 
is exhausted, whtchever comes first. However, before an ID 
is removed, a notice will be sent to the person responsible 
for the account, notlfying: him of*thatetocu 


One or more boxes, as appropriate, should be checked In 
item (8) to indtcate what virtual machine capabilities are 
requested. —-Ilf "LARSYS Ver 3" Is requested, it will ine lide 
as much CMS as is needed (tncluding one cylinder of 
permanent disk storage space). In general, one should check 
"CMS" only if facilities for writing and debugging prorrams 
(instead of only running operational programs) are to be 


included. lf CMS is requested and approved, this will 
normally include 4 cylinders of permanent disk storare 
space. If unusual characteristics (unusual core _ size, 


unusual ditsk size, access to special disks, etc.) are 
required, they can be . described under “SPECIAL FACT LIMGS = 
It ts expected that users requesting CMS will attend = an 
introductory course on CMS. (For more Information on this 
course, contact Jeanne Etheridge. ) 


If any magnetic tapes are to be written on ustnp this 
In; they’ should” be listed ‘!'n section (11) 2 The | “owner 
name" listed there (and on the tape Itself) presumably ought 
to match elther the name on line (1) or one of the names on 
Pine e9) = (See section 1.4.4 for more Information on 
magnetic tape usare.) 


It is sometimes desirable to establish more than one ID 
to draw on the same account number. If this is destred, each 
requested ID should be entered on line (7) -- the example 
shows two related ID's. If each of a group of related ID's 
is to draw on its own account number, or to have its own 
untque information on lfnes (4) and (6), then a separate 
request form should be used for each one. Checking the 
approprfate box in line (5) allows one to request a new IPD 
with the same account number as a_ previously existing one. 
Note that if more than one ID exists for a given account 
number, they will not appear separately in the monthly — 
account reports. 


IAD HOW TO REQUEST: CHANGES IN .A. COMPUTER. [D7 OR 


ACCOUNT Any request for mocificatfons to a computer 1) or 
account should be directed to Jeanne Etherldge and siould 
come from eittier the person responsible for the account, or 
from hits project supervisor (the project supervisor must 
approve funding changes). Most requests for chanzes can be 
nandled over the telephone, or by sending an Informal note. 
Examples of changes Include funding changes (add to or 


decrease the number Of «CPUL hours “Tfandins on change 
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expiration date), deletion of the account or ID, addittons 
to or deletions from the Ilflst of tapes authorized to be 
written by an ID. 


1,5,3 ACCOUNTING PROCEDURES AND REPORTS Each week the 
system accounting data is run through an accountings program, 
A memo is generated and sent to the person responstble for 
the account if an ID will expire within the next two weeks 
or if it has overrun the hours funded, or {ff it Is about to 
overrun the hours funded. A form is attached to the memo 
which the project supervisor may fill out, for example, to 
request more hours, delete the ID, or change the exptratton 
date. If no response Is received within the seven day pfrace 

eriod and the ID has overrun the hours funded, the ID will 
automatically be deleted. 


At the end of each month, two accounting reports are 
sent to each project supervisor or remote terminal site 
specialist concerning each account category for which he is 
responsible. The first one is a one-page report givins the 
computer time used by each 1D In the category, with totals 
for the category appearing at the top of the page. Included 
In the Information given = are the number of terminal 
sessions, number of batch jobs (see section 4.3) run, total 
nMours (clock-time) attached to the system (broken down by 
terminal sessions and batch jobs), total CPU hours used this 
month (also broken down by terminal sessftons and = batch 
jobs). At the far right of the page are summaries: of the 
account status, including the number of CPU hours requested 
for the account and the total number of hours already used 
since June lst of the current fiscal year. The total of all 
these “hours requested" for all the accounts In an account 
category wlll be less than or equal to the number of hours 
authorized to be requested for that account category. 


The second monthly report glves detalls of LARSYS 
Verston 3 usage for the month. It is a one page report for 
the category and contains the following Items for each 
LARSYS function: number of times used, number of check-out 
runs, elapsed ‘clock time, virtual CPU time, and) coitotal CPU 

ime. Each of these three times is further subdivided into 
otal, minimum, average, and maximum times. Totals are 
ncluded. 


Leer 8 MAGNETIC: TAPE USAGE POLICY AND PRACTICE The 


PURDUE/LARS Computer Center currently manages about 2500 
reels of magnetic tape. Many of these reels comprise a data 
base of remote sensing multispectral Image data. In 
addition, tndividual users may have tapes assigned to them 
for use in storing their own data or results. 


All magnetic tapes used at PURDUE/LARS have tape 
numbers assigned and are kept In correspondingly numbered 
slots In the tape racks. The computer center staff will 
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ensure that each assigned reel bears a "tape identification 
label" containing the following Itnformation: 


a. Tape Number 

b. General use for which tape is Intended 

c. Name of person responsible for tape 

d. List of user-id's authorized to write on tape 


Each project area or remote terminal site may be 
assigned one or more contiguous blocks of tapes. This is 
arranged by the project supervisor together with Jeanne 
Etheridge. As part of this procedure an "owner" will be 
destgnated for each tape. This "owner" may make changes 
(e.g. add or delete items from list of user-id's authorized 
to write on tape) by contacting Jeanne Etheridge, or by 
including the informatton on a new "Request for PURDUE/LARS 
Computer ID." 


Although each tape is assigned to a specific person 
(the “owner*)) who-uds o respons! blessfor, dtses conten tses) aus 
computer operators and operations supervisor are responsible 
for the physical handling of the reels. (No tanes are to he 
removed from the computer room, except by going through the 
computer operations supervisor.) Any tape may be read and 
requested by any user; however, only user-Id's authortzed by 
the etapen"ownert' sand Listeth onis the:taper Identd Fleatied 
label" will be able to request, that a tape be mounted so 
that it can be written on. 


In addition, users are strongly urged to request that a 
"tape contents label" describing current contents and date 
last written be made for each tape each time It Is written. 
This can be done as suggestec hy the following examples: 


Example 1- To create a new contents label (which 
replaces all current contents labels): 
M CP TAPE 999 NEWLABEL = "CLASSIFICATION RESULTS - RUN 
66000600" . 


In this case the computer operator wlll write out a 
label with today's date and the requested informatlon and 
use {It to replace all current labels on the tape, The 
information will also be recorded In the tape usage lov. 


exemple 2a Maddittotla derbi - 
M CP TAPE 999 ADDLABEL = "FILE 3 - RUN 66000601" 


In this case, all labels on the tape will rematn, and a 
new one with today's date and the requested Information will 
be added. 
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2,1 THE COMPUTER AND ASSOCIATED HARDWARE 


The PURDUE/LARS computer facillty ts based around an 
IBM 360 Model 67 machtIne. The current configuratton 
includes 512K bytes of core memory (Ci.e., 128K 32-bit 
words). Unit record equipment (two card readers, one punch, 
and two printers) as well as user terminals are connected to 
the CPU via a multiplexor channel. Nine 9-track and one 
7-track magnetic tape units are connected to the CPU via two 
selector subchannels. A drum storage unlit has’ a dedicated 
selector channel, while elght disk storage drives share a 
second selector channel with a spectal digital image display 
and editing unit. 


The Model 67 Is a unlque member of the 360 serfes In 
that It has special hardware features to perform dynamic 
address translation and hence to operate efficlently in a 
time sharing mode. 


2.2 COMPUTER SYSTEM SOFTWARE 


A aA CP-67 AND THE VIRTUAL MACHINE CONCEPT The 
basic monitor program or control program under which’ the 
PURDUE/LARS computer operates Is called CP-67. teri sia 
multi-programming package which uses . the special time 
sharing hardware features of the Model 67 to create an 
environment in which {ft appears to each one of several users 
that he has complete control of a dedicated model 360 
machine, complete with !/0 devices. These apparent machines 
are called virtual machines since they are software created 
and do not exist in any physical sense. The virtual 360 Is 
indistinguishable to the user and his programs froma real 
SVStem/5o600, but. It) is) really one of ‘many “that CP is 
managing. CP allocates the resources of the real machine to 
each virtual machine In turn for a short "slice" of time, 
then moves on to the next user's virtual machine -- thus 
time sharing. 


SInce the real machine does not have suffictent real 
core storage for all users’ virtual core, a technique called 
"onaging” Isioused | by CP.) Virtual ‘core Ils - divided [nto 4096 
byte blocks called "pages". All pages except those currently 
in use are kept by the system on secondary storage (drum or 
disk), and are called Into and swapped out of real corre on a 
demand basis. In addition, all virtual machine’ Input- 
output is handled by CP -- however, all these operations are 
completely transparent to a user and his virtual machine. 


Stnce the virtual machines are simulated, In principle 
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their configurations may differ from each other anc from the 
real machine. In practice, most virtual machines have the 
following configuration: 


512 bytes of core storage 


Operator's console ~ (address 009) 
Spooled card reader - (address 00c) 
Spooled card punch - (address 00¢) 
Spooled printer - (address 090c) 
Disk storage drive - (address 196) 
Disk storage drive - (address 191) 
Disk storage drive - (address 19c) 


CP also provides, as part. of the virtual computer, 
commands that parallel the buttons and switches on a real 
machine's operator's console. The user: can Issue.-.these 
commands from his termtnal, and thus, his terminal becomes 
the pseudo-console for his virtual machine. 


CP-67 simulates card reader, punch and printer 
operations for a virtual machine. If a program running on a 
virtual machine jis to process a_ card file, that card fille 
must.-first.be read in to €P,) headed by »an 40 cardue 
identify which user's virtual machine avit (hs? eintendeds ome 
it Is. then’'stored asia (disk file In CP's so-calied’® spoolame 
area. When the virtual machine requests card-reader input, 
CP supplies it with card Images from the spooled Input file. 
The same process works in reverse for printer and punch 
output: a» disk spooling of tle tsi created, which  dsalater 
transferred by CP from disk to a real printer or punch. 


APE CMS After the control program creates the 
virtual computer, that virtual computer must be equipped 
with its own operating system to provide support for the 
programs to be run. The programming system most commonly 
used at PURDUE/LARS is called CMS. 


CMS (Cambridge Monitor System) is a stnrle-user, 
conversational operating system designed to provide full use 
of a System 360 machine using a simple command lanruage that 
can be entered at the terminal. CMS provides a full range 
of capabilities - creating and managing filles, comptling, 
debugging, and executing programs, etc. 


Section 5.1 contains more Informatton on CMS. 


The LARSYS Version 3 system (Section 2.3) Is based on 


CMS. 


2.3 APPLICATIONS PROGRAMMING SYSTEMS - LARSYS 


LARS' capability for processing multispectral remote 
sensing data ts Implemented as a computer software package 
known as LARSYS. The basic intention of the data analysts 
part of the package is to’ facilitate man-machine 
conversation so that the analysis scientist may more quickly 
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pose questions and obtaln results. 


The LARSYS system Is extensively documented (See 
Section 3.3) and the user Is referred there. 


2,4 DATA LIBRARY 


The basic data processed by LARSYS [s matntained In a 
library of Multispectral Image Storage Tapes (data storage 
tapes). In general, the data from an alrborne or 
satellite-borne multispectral scanner Is sampled and 
digitized if necessary, and then reformatted to produce the 
computer-compatible multispectral Image tape In the 
particular format required by the LARSYS system. The latter 
contains the data for each resolution element stored Ina 
packed format, and has a specific address for each poftnt In 
the form of a scan line number and sample number. Certatn 
other Information, such as run number and date, necessary 
for machine storage and retrfeval are also stored In a 
conventent format. 


The system has a disk data file called "“RUNTABLE" that 
can be accessed by anyone. It contains the essential 
Information about all runs In the data Ilbrary avallable for 
analysts. A listing of It Is matntained In the LARSYS 
system and can be convenlently obtalned when desired (ustIng 
the LARSYS command ‘REFERENCE RUNTABLE'). Coples of the 
listings of RUNTABLE should also be posted at each terminal 
site for general reference. 
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3,0 DOCUMENTATION 


3,1 PURDUE/LARS COMPUTER USER'S GUIDE 


The Computer User's Guide Is destgzned to document the 
basic information needed to use the computer. It will be 
distributed to any PURDUE/LARS computer user upon request, 
and copies will also be supplied to the Hardware/Software 
specialist at remote terminal sites. Requests for tiie Guide 
(as well as requests for all documentation) should be made 
to the Data Processing secretary (extension 239). (Users at 
remote terminal sites should request all documentation from 
thelr local Hardware/Software Specialist.) As changes In 
Information occur, the guide will be kept up to date by 
preparing replacement pages containing the new Informatton 
and distributing them to all people who have coples of the 
Guide. To this end, the data processing secretary willl 
maintain a list, and anyone who wants to receive such 
updates should make certain his name ts on the Ilist. 
Notices of updates wlll also be posted via the system "NEWS" 
rfactlity «(Section 3.2). 


Suggestions’ for’ changes.’ In’ the’ User*s, Guide suas 
especially includes items which are unclear, misleading, or 
incorrect) should be directed to Howard Grams. 


S32) JIHES SYSTEM NEWour re AG holly, 


Users of the computer have access to a "bullet!tn board" 
or "news" facility to alert them to updates or changes tn 


programs, facilities, schedules, and documentatton. To 
obtain the latest system news, a user need only (1) login, 
(2) type "ft Varsys''; and (3)! type “news. 


The command "NEWS" will type out the latest system news 
- a brief file containing Items of general interest. More 
specific information about the LARSYS programming system can 
be obtained by typing the command "NEWS LARSYS"., The latest 
operations schedule can be obtafned from the command "NEWS 
SCHEDULE". 


3,3  LARSYS PROGRAM DOCUMENTATION 


The formal documentation of the LARSYS system Is 
tvided Into three parts: The "LARSYS Users Manual", the 
"LARSYS System Manual", and the “"LARSYS Program Abstracts." 


The "LARSYS User's Manual" (tn three volumes) contalns 
a comprehensive description of the functtonal orvsanizatton 
of the system, the processing functions provided, and the 
manner In which the functlons are Invoked and controlled, 
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While it is written for the system user, a good knowledze of 
its contents is essential for any Individual who intends to 
work with the system - be he a user, an analyst, or a 
programmer. 


The "LARSYS System Manual" Is directed primarily to 
programmers and analysts who maintain or revise the system, 
or write new functions that must be Interfaced with LARSYS. 
It contains detailed Information about the hardware = and 
software framework upon which the system was bullt, the 
internal organization of the data filles, and a discussion of 
special techniques that were used in the Implementation of 
BARS YS « 


The "LARSYS Program Abstracts" comprise a collection of 
individual documents, each with its unique’ identifying 
Abstract number, one for each Fortran, assembler, or EXEC 
routine In the system. These abstracts are Intended for 
programmers who may need to revise and/or matntatin these 
routines. 


Note that up-to-date reference listings of LARSYS 
commands and control cards are avallable from the computer 
via the REFERENCE command of the LARSYS system. 


3.4% 1BM MANUALS 

A comprehensive collection of IBM manuals. describing 
hardware and software aspects of the system is maintained Jn 
the computer area, and an abridged collection should be 


maintained near each remote terminal. The more Important 
ones are lIsted below: 


Hardware 


Form GA27-3001 "IBM 2740/2741 Communications 
Terminal - Operator's Gulde" 


Form GA27-3005 "I8M 2780 Data Transmisston Terminal 
- Component Description" 
FORTRAN Language 
Form GC28-6515 "IBM System/369 9 and System/370 
Fortran IV Language" 
CP-67 OPERATING SYSTEM AND CMS OPERATING SYSTEM 


Form GH20-0859 "Control Program - 67/Cambridge 
Monitor System - Users Gulde" 


(Note: This manual ts updated for PURDUE/LARS 
Users with memoranda describing local addittons 
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4.0 HOW TO USE THE COMPUTER 


hol SIGNING UP FOR SYSTEM: RESOURCES 


The configuration of the computer hardware Is 
constantly being monitored and re-evaluated, with attention 
given to such questions as the usare of and need for scarce 
resources (tape units, disk storage space, user terminals). 
Even wlth a perfect hardware mix, however, there would be 
times when more users want to use drives or terminals than 
there are drives or terminals available. The computer 
operations staff attempts to deal with this problem so that 
maximum user convenlence can be served, 


One such procedure is that of signing up In advance to 
use terminals or tape units. 


Sitgn-up policy for terminals Is set at the individual 
terminal locattons - details and sign-up sheets are 
avallable at each location. 


LARSYS automatically requests tape drives from the 
computer operator when needed, and releases them when done. 
It should not be necessary for LARSYS Version 3 users to 
specifically reserve tape drives, since a number of drives 
(currently five of the total ten) are reserved for use by 
LARSYS Version 3 users. 


Users of LARSYS Version 2 and progerammers may sifn up 
for tape drives tf desired and if reservable drives are 
still availahle to accommodate them. In _ practice, It Is 
often found that this is not necessary and that a drive may 
be requested when needed. The operator may assign a "LARSYS 
Su tape drive to a "non-LARSYS ai usert! WITH THE 
UNDERSTANDING THAT IT MAY BE PRE-EMPTED later If needed for 
a user using LARSYS Version 3. 


Any user wanting to reserve magnetic tape drives may 
want to call the computer operator ahead of time to reserve 
them. This can be done by calling extenston 233 (LARS 
users), by using the voltce facility (Tf one exists) of a 
remote terminal's communications link, or by logging In at a 
terminal and using the CP message facility. Be prepared to 
give the User ID you will be using so that when you lor In 
and need the drives attached, the operator will know that 
you are the person who signed up. 


IMPORTANT 


It should not be necessary to pofnt out that it Is very 
wasteful of resources as well as quite inconsiderate of the 
nother guy" to sign up for resources you do not’ use, 


Accordingly, if your plans change and you are not able to 
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use the terminal or tapes when you have reserved them, you 
should release them for. someone else@ >? toi use as®early as 


anssible. in this’ respect, observance of “ado unto. oun 

will rear you great dividends as, initurn, others "do unto 
ih 

yours 


4.2 RUNNING INTERACTIVE JOBS 


This section first gives theayv basic information 
necessary to operate the terminal equinment, then the basic 
information necessary to invoke the software system. 


The first part of this section deals with procedures 
for use of the computer from ithe: polnt of viewlofea tiservar 
a remote site equipped with a 2780 high speed terminal. The 
last’ part (4.243) Adealsowi'th! procedures! meauired atGese 
central computer site. 


2,1, OPERATING A 27481 - TYPEWRITER TERMINAL ~ The 27a 
consists of a Selectric typewriter with additional 
electronics needed for communications. It has two modes of 
Operation: communicate mode and local mode, which are set 
by the mode switch on the left side of the typewriter stand, 
When tn local mode, it fs disconnected from the computer and 
functions as a typewriter only, and no Information is 
transmitted or received. To use the typewriter in either 
local or communicate mode, the power switch on the right 
side of the keyboard must be ON (and the terminal must be 
plugged In). 


The steps for preparing the 2741 for use are described 
phelow. After these steps have been performed, the user may 
login to the system. 


1. Make sure the terminal is plugged In, then press 
the ON portion of the power switch at the right 
side of the keyboard. 


2. Set the margin stops (located on the typing guide 
just above the keyboard) to the destred positions 
(normally about 10 and 120). To reset a margtn 
stop, push fit In, move ft to the desired position, 
and release jit. 


De The paper may be released and = stralghtened hy 
moving the paper-release lever forward (the stlver 
lever to the extreme upper right rear, behind the 
platen (roller)), and then pushing tt back when 
finished. The paper may be manually allened up and 
down (to avold typing on the printed lines) by 
pressing In the left platen knob and rotatInp up or 
down. 
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u, Check that the mode switch (on the left side of the 
stand) ts set to COM, The terminal Is now ready 
for use, 


A more detailed description of the 2741 can be found fn 
the publication "IBM 2780/2741 Communicatltons Terminal - 
Operator's Guide", Form GA27-3001. A copy should be located 
at each terminal site. 


ree OPERATING THE 2780 HIGH SPEED TERMINAL The 
2780 and its associated software enable a remote user to 
read cards directly into the spooled reader of his virtual 
machine (even before he logs In, if desired). He can also 
receive printed and punched output from his spooled output 
rrhes. 


4.2.2.1, GENERAL CONSIDERATIONS 


1. A more detaltlled description of the 2780 
(including error recovery procedures) 
can’. be found’: ir’ the’ publication "IBM 
2780 Data Transmission Terminal 
Component Descriptions", Form GA27-3005. 
A copy should be located at each 
terminal site. In addition, at each 
site there Is a designated 
hardware/ software speclaltst who Is 
familiar with the operation of the 
terminal and with recovery procedures. 
In case of trouble, he should be called. 


2. Do not change the setting of the mode 
switch (the dial switch on the 


reader/punch console) while any 
printing, punching, or reading Is goltng 
on. First press the appropriate STOP 


key. CPrstinserule 1s". lenored,;, tne 
printer type bar will probably jam and 
will need to be reset. Call your site 
coordinator.) 


3. Whenever the OVERUN, RECORD, INCP, EQUIP 
“GHECK,.”. DATA ~“CHECK or PARITY -CHECK 
indicator lights eurn. Orn; It is 
necessary to reset the 2780 before 
resuming operation. This can be done by 
turning the mode switch to another 
setting and then back to the = oristinal 
setting. 


bee 2 ed, IO. TREAD CARDS “A*dteck of cards can. be read 
when there Is no other activity on the terminal or by 
Interrupting printing or punching. (Im the latter case 


there 
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a. possibility of .over. printing, or recetving 


duplicate print lines when printIng Is resumed.) 


A. 


There fs no activity on the 2780 
1. Remove blank cards from card read/punch hopper. 


feos Clear the card read/punch stations by 
depressing the MNPRO key. 


3. Place iyour..card deck.in the hopper. - Jit, must be 
preceded by an ID card (letters ID {In col 1-2 
and=yoursspecifilc.user-ilId-ber|inning in, colo. 


4, Turn the mode switch dial tos. TSM.  fRspe 
CAUTION! ! Never turn this switch while’ the 
terminal ts in operation. (Depress the STOP key 
frst) 


5. Depress the. END OF FILE key. 


6. Depress the START key, anc keep {ft depressed 
until the READY light comes on. 


7. After all cards are read, the terminal will 
commence beeping. You can stop {[t by rotating 
the mode switch to some ther setting. 


The 2780 its tn active printing or punching. 


0. Depress the STOP key under the mode switch 
dial...» Clt..ds recommended you. ‘try.to, dos Giese 
between pages, since when printing resumes, 
there Is a chance of receiving a duplicate ltne 
or .of .overprinting a line already printed, 
Similarly, one or two duplicate cards may be 
produced If punching.) 


ee?) Follow the same steps as [nn procedure A 
above. (Note: If you are reading Vineet 
single CANPRT or CANPCH cards described below, 
do not use an ID card.) 


Loi okbl.t ENDORSE LUE key. 


5. In rapid -sequence: 
(a), turn the mode switch to TSM TRSP, 
(b) depress and hold down start key unttl 
ready light comes on. 

NOTE: You.» mus. doe iboth-wi eno thet space of 
about 5 seconds - before the terminal starts 
beeping. If you do not succeed, turn the mode 
switch to some other posftton, and repeat 
beginning at step 4&. 


6. After all cards are read, the terminal will 
again start beeping Cstenifying ‘that’ Vewant. 
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to resume printing or punching the interrupted 
output. Rotate the mode switch to PRINT (or 
REC) and. press START on the printer. Or _ load 
blank cards in the punch, rotate the mode 
switch to PUNCH, and depress the START key 
under the mode switch dial. Or load blank cards 
in the punch, rotate the mode switch to PUNCH, 
and depress the START key under the mode switch 
dial. 


bo2,2.35 TO RECEIVE OUTPUT To ensure that the 2780 Is 
ready to receive output whenever required, It Is recommended 
that the following setting be maintained at times when other 
functions are not being performed. 


1. Turn the mode switch to REC 


2. Ready the printer by making sure paper Is Inserted, 
then depressing the START key on the. printer 
control panel. 


as Ready the punch by placing blank cards In the 
hopper then depresstIng the START key on the 
reader/punch and holding ft In until the READY 
light comes on. ; 


If only printer output Is expected, step 3 may be 
omitted, and the mode switch in step 1 may be placed either 
at o°PRIENT ort REC. Stmilarly tf only punched output Is 
expected, omit step 2 and use either the REC or PUNCH 
positions In step l. 


eet G8 ei) CAN PRINTER OR PUNCH Fl lf the 
2780 is printing or punching, and tt is determined that the 
remainder of the output is no longer wanted, it may be 
terminated by reading in a stnele card (don't use any ID 
card) - with CANPRT or CANPCH punched in columns” 1-6 
depending on-whether a printer or punch flle fs to he 
cancelled. This single card is read in using the procedure 
B whic isect.ton of. 2ia2.2 6. After step 6 is performed, a few 
more lines will be printed, followed by the message OUTPUT 
CANCELLED BY REQUEST. 


ogy) ORERALING JHE. 2501] .<CARD READER. .The.2501 card 


reader Is used by people using one of the 2741 terminals In 
the computer room, Its operation Is somewhat simpler than 
that of the 2780 described akove. 


Ae Place card deck tn hopper and cover with card 
welght. Don't forget the ID card. 


2. Hit END-OF-FILE and then START, tn that sequence. 
at If the reader stops before all cards are read, 


check with the computer operator on duty for 
assistance, 
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4.3 RUNNING BATCH JOBS 


Batch jobs run In a_ disconnected CMS’ virtual machine 
under CP-67. The virtual machine remains dormant until a 
job ts read into the card reader. The batch virtual 
machines run at all times - a user does not need to login to 
the computer at all, he merely drops his job [nto a card 
reader and his output comes out as soon as the job fs done. 


4.3.3, LARSYS BATCH JOBS LARSYS Version 3 jobs can be 
run on a_ special batch machine and are submitted through a 
card reader (or they can be submitted by a user logged In at 
a typewriter terminal.) Details are given In Sectton 3.7 of 
the "LARSYS User's Manual." 


Currently one such batch machine Is avallable, with the 
ID of BTLARSYS. Jobs read In are executed in the order In 
which they are received. Output Is returned to the site(s) 
specified on the BATCH OUTPUT card. 


Several points about, this system should be noted by 
users: 


1. $&If the machine should crash (heaven forbid) while 
a batch job Is executing, the job may or may not 
be restarted when the computer [s brought back 
up. This depends on whether or not’ all control 
cards had yet been read, and how serlous’ the 
crash was. If the job does not get restarted, I[t 
must be re-submIitted by the user, sInce neither 
the system nor the operator has the appropriate 
deck avallable. 


2. There Is at present no practical way for a user 
to find out how many jobs there are In the queue 
ahead of a job just submitted, and hence how long 
before one might expect a job to be finished and 
output to be produced. 


Lees VIAL DIYS BATCH UOBS A versatile capabllity for 
a utility virtual machine has been developed. This system Is 
currently Implemented to handle very short utIility-type 
functions, such as deck listing, deck duplicating, listing 
or duplicating information at a remote site, tape copying 
and dumping, etc. 


A job deck conststs of the following four cards In 
order (followed optionally by data cards)... 


1) A CP-67 ICD card havine the user-id of the UTILITY 
virtual machine. (C"UTILITY" must start In column 
Foe 


2) A "Batch ID" card, with the four flelds BATCH ID 
"Userid' ‘username’. The words BATCH and !D appear 
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exactly as shown, separated by one or more spaces. 
A user tnserts his own ‘user-Id' and his. name or 
the name of the person who fs to receive’ the 
output. The name can be up to 16 characters long, 
and may include blanks and punctuation. Note that 
If any tape Is to be written on, the authortzed 
ring-tIn 1D listed on the tape's labels.» must match 
‘the ‘user-id' given on this card. 


3) A "Batch Output" card, with the four flelds BATCH 
OUTPUT 'printloc! "punchloc'. The words BATCH and 
OUTPUT appear exactly as shown, separated by one or 
more spaces. The ‘orintloc' and "punchloc! 
parameters are used to control the location where 
output Is produced. (If these are omitted, they 
default to Flexlab2.) 


4) A job deftnition control card. Four formats are 
currently recognized. Each begins’ fn column 1 and 
must be punched exactly as shown. 


DECKLIST 

DECKDUP 

EXEC filename parml parm2 = parmetc 
EXECnn 


If the "DECKLIST" control card Is recognized, all 
remaining cards in the deck will be printed on the 
printer (at the locatlon specified as 'printloc' on 
the BATCH OUTPUT card.) 


lf the "DECKDUP" control card [s_ recognized, all 
remalIning cards In the deck wlll be punched (at the 
location specified as 'punchloc' on the BATCH 
OUTPUT card). 


If the "EXEC filename" control card ts recognized, 
a search wlll be made for that EXEC file on the 
LARSLIB 1 source/text library disk. toe LG ins 
found, {t will be executed. One or more optional 
parameters may be passed. 


If the "EXECnn" control card Is recognized (nn are 
two digits between 01 and 99), a new temporary EXEC 
flle is created using the next nn cards’ Into the 
file. That temporary file Is then executed. (This 
procedure is useful for Initial checkout and 
testing of procedures that are intended to go later 
on the LARSLIB 1 disk). 


EXAMPLE 1 - DUPLICATE A CARD DECK 


This example shows a user named John Doe duplicating a 
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card deck at Flexlabl. His user-id ts MYID. 


1D UTILITY 
BATCH 1D MY ID JOHN DOE 
BATCH OUTPUT FLEXLABI1 FLEXLAB1 
DECKDUP 
Cards to be duplicated 


EXAMPLE 2 = PRINT JA SLISTING OF “A CARD DECK 


This example shows a user named Jim Dane producing a 
listing of a card deck. For the purpose of this example, 
assume that he [{s located at the Houston remote terminal. 
He has used his own user-id MSCQJK, but has specified the 
output to be printed at Flexlab2 instead of Houston and to 
be labelled with the name of Jeanne Etheridge instead of hls 
own name. In this way Jim Dane can send a copy of a listing 
of his card deck to be examined by Jeanne Etheridge (say he 
is having a problem with a job deck and needs to have 
someone look at his control cards). 


ID UTILITY 
BATCH 1D MSCQJK JEANNE ETHERIDGE 
BATCH OUTPUT FLEXLAB2 FLEXLAB2 
DECKLIST 
; A few cards punched with Information 
describing the rest of the cards. 


‘ Cards to be lIsted. 


EXAMPLE 3.2 COPY, TAPES 


Any tape copy job can be done, Including straight copy, 
7 potrack 4.to, 9. «track m convers | On ,«, 1600, sbnles ita, Bb 00meb ae 
conversion, etc. It Is not necessary to know the number of 
bytes In a physical record (block), and any blocksize up to 
32767 bytes ts acceptable. (This program - TAPCPY - can 
also be used from a terminal and full detalls are given In 
PURDUE/LARS Abstracts 0610 and 0611. It Is more versatile 
than the CMS command TPCOPY, since the latter has a maximum 
blocksize of 4096 bytes.) 


In this example, John Doe Is converting from 1600 bpl to 800 
bpt. 


1D 
BATCH 
BATCH OUTPUT FLEXLAB2 


OTIC Ty 
ID QJCK5 JOHN DOE 
FLEXLAB2 


EXEC TAPUTL RDCOPY 
TAPINC1052),MODINC16), TAPOUT( 828) ,MODOUT(17) 


Notes on Tape copying: 


CARD 4 


- Contains the 


letters 


columns 1-18. 


CARD 5 =- Contains options (In 
Liste ; 


Option 
TAPINCXXX) 
MODIN(CXX) 
START(XX) 


TAPOUT( XXX) 
MODOUT( XX) 


SKIPCXX) 


COPY (XX) 


rpose 
Tape to be copied from 
Mode of input tape (see below) 


Start copying at this fille on 
input tape 


Tape to be copied to 
Mode of output tape (see below) 


How many filles to skip on 
output tape 


How many files to copy 


CODES FOR MODIN AND MODOUT 


CODE 


O 
SNS NNN NNN NN NN NNN OO OO 


TRACKS 


DENSITY PARITY CONVERTER 
800 bpi (not applicable) 

1600 bpi (not applicable) 
200 bpi Even off 
200 bpi Even of f 
200 bpi Odd of f 
200 bpi Odd off 
200 bp!I Odd on 
556 bpi Even oft, 
556 bp! Even of f 
556 bpft Odd of f 
556 ebehn Odd of f 
556 bpli Odd on 
800 bpfi Even of f 
800 bpi Even of f 
800 bpi Odd of f 
800 bpi Odd of f 


800 bpi Odd on 


"EXEC TAPUTL 
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RDCOPY' In 


any order) from the following 


Default 
(None) 
MODIN(16) 


START(1) 


TAPOUT(SCRATCH) 


MODOUT(16) 


SKI PCO) 


Copy untl] 
two 
consecutIlve 
EOF marks 


TRANS LATOR 
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A printer file will be created containing a log 
detailing what was requested and copied, and any error 
messages if errors occurred. (The error codes are discussed 
in the documentation of the TAPOP module. ) 


EXAMPLE & - DUMP A TAPE 


User John Doe, at Flexlab2, wants to dump the first two 
files of his tape number 1234. He ts ustng the TAPUTL 
program (described tn more detall In PURDUE/LARS Abstract 
g12)...Note that at present seven-track tapes cannot “be 
dumped ustng TAPUTL. 


1D UTILITY 

BATCH 1D MY ID JOHN R. DOE 
BATCH OUT PUT FLEXLAB2 FLEXLAB2 
EXEC TAPUTL RDDUMP 


TAPE(1234),HEX,LREC(10),LFILE(2) 
Notes on tape dumping: 


CARD 4& - Contains the letters ‘EXEC TAPUTL RDDUMP' {In 
columns 1-18, 


CARD 5 = Contatns options (In any order) from the following 


list: 

Option Function Default 

TAPE( XXX) TAPE XXX ts requested to be (None) 
dumped 

BCD Tape ts dumped In BCD format HEX 

HEX | Tape Is dumped In HEX format HEX 

IRECCXXX) XXX Is the first record In each IREC(1) 
file to be dumped 

LREC( XXX) XXX Is the last record [fn each LREC(99999) 
file to be dumped 

PFI LECXXX) XXX ts the flrst file to. be IFILEC 1) 
dumped 

LFILECXXX) XXX is the last flle to he LFILE(1) 
dumped 


EXAMPLE 5 - USING THE EXECnn OPTION 


John needs to produce a listing of a deck of cards that 
has been punched with carriage control characters in column 
l of each card, This can be done ustIng the CMS command 
OFFLINE PRINTCC,. He creates a 3 card temporary EXEC file 
using the EXEC03 control card. This file reads the rest of 
his deck into a disk file mamed INPUT CARDS, then OFFLINE 


PRINTCC's it and ERASE's it. 
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1D UTILITY 
BATCH 1D MYID JOHN DOE 
BATCH OUT PUT FLEXLAB2 FLEXLAB2 
EXEC03 
OFFLINE READ INPUT CARDS 
OFFLINE PRINTCC INPUT CARDS 
ERASE INPUT CARDS 
‘ Input card deck to be listed. 


Note In connection with this example that 


virtual machine is only configured with 
Thus the deck of cards that Is read 
CARDS should not be larger than about 
file INPUT CARDS will be too blg to 
P-disk. This will cause the UTILITY 


abnormally terminate and log Itself out. 


the UTILITY 
a l-cylinder P-dtsk. 
Into the file INPUT 
1300 cards, or the 
be contalned on the 
virtual machine to 
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5.0 NOTES FOR PROGRAMMERS 


Sel CMS 


Most usage of the computer for program development Is 
through the use of CMS (Cambridge Monitor System) -- See 
Section’ 2 e222. The PURDUE/LARS Technical Support Group 
periodically conducts a short introductory course [fn the use 
of CMS, and [t Is expected that each person who wants to use 
CMS will have first attended the course. 


S5,1,]. O'1SK SPACE FOR CMS USERS When authorization to 
use CMS Is approved and an ID is set up, the user wlll have 
private disk space defined for his. virtual machine (Chis 
P-disk) that may be used to store programs, procedures, and 
data from one’ terminal sesslon to the next. The amount of 
such disk space actually avallable on the real computer Is 
limited, and ft Is expected of each user that he develop and 
practice procedures for making the most efficlent use of his 
quota of space. This Includes, for example, keeping files 
not ou used at the moment on back-up storage (tape or 
cards). 


cede 2. BACKUP PROCEDURES It should be emphasized that 
each CMS user should frequently backup his entIre disk to 
tape for safety purposes. The computer staff does not 
backup any user disk areas, and although [t seldom occurs, a 
hardware crash could cause loss of all files on any disk. 
Far more likely Is the occurrence of an Inadvertent user 
error that wipes out his disk, or makes [It unreadable. A 
convenient method of backing up user CMS disks ts provided 
by the CMS command BACKUP - [t Is described In an addendum 
to the CP/CMS Users Guide, and Its regular use [fs highly 
encouraged. 


PRINTER AND PUNCH OUTPUT All printer and punch 
output {s normally produced at. the malin computer sIte. A 
speclal CP command ("REMOTE") exists that Is used to cause 
output to be produced at a remote terminal sfte, and [t must 
be Issued by any user (Including a CMS user) who wants hls 
output produced on his 2780 at his remote terminal sIte, 
LARSYS (both Verston 2 and Versfon 3) contain programming 
that Issues the REMOTE command automatically by sensing 
which 2741 terminal [ts belng used and then REMOTEIng printer 
and punch output to the same physical location. 


The CMS user can utilize the same automatic senstng of 
location and Issulng REMOTE command by ustng the CMS command 
WHERE - ft ts described In an addendum to the CP/CMS Users 
Guide. The recommended method of use Is to Include the 
WHERE command within the user's PROFILE EXEC, so that It Is 
automatically Issued whenever he logs In and Ipl's CMS. 
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